.\"   $Id: getlosig.3,v 1.1 2002/03/08 13:51:02 fred Exp $
.\" @(#)getlosig.2 2.11 91/08/22 ; Labo masi cao-vlsi; Author : Frederic Petrot
.if t \{\
.so man1/alc_contents.mac
.XS \n%
.ti 0.2i
getlosig
.XE
.XS2 \n%
.ti 0.2i
getlosig
.XE2 \}
.TH GETLOSIG 3 "October 1, 1997" "ASIM/LIP6" "MBK LOGICAL FUNCTIONS"
.SH NAME
getlosig \- retrieve a logical signal
.so man1/alc_origin.1
.SH SYNOPSIS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mlo.h"
losig_list \(**getlosig(ptfig, index)
lofig_list \(**ptfig;
long index;
.ft R
.fi
.SH PARAMETERS
.TP 20
\fIptfig\fP
Pointer to the figure in which the signal should be seeked
.TP
\fIindex\fP
Index of the signal
.SH DESCRIPTION
\fBgetlosig\fP looks in the list of signals of the logical model pointed
to by \fIptfig\fP for a signal identified by its \fIindex\fP. This signal
is unique, since the \fIindex\fP is the signal identifier.
.SH RETURN VALUE
\fBgetlosig\fP returns a pointer to the signal that matches the
\fIindex\fP.
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"\(**\(**\(** mbk error \(**\(**\(** illegal getlosig signal \fIindex\fP doesn't exist
in figure \fIptfig\->NAME\fP" 
.ft R
.RS
No signal has \fIindex\fP as \fIINDEX\fP in the figure.
.RE
.SH EXAMPLE
.ta 3n 6n 9n 12n 15n 18n 21n
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mlo.h"
losig_list \(**get_sig_by_name(figname, index)
char \(**figname;
long index;
{
   return getlosig(getlofig(figname), index);
}
.ft R
.fi
.SH SEE ALSO
.BR mbk (1),
.BR lofig (3),
.BR losig (3),
.BR addlosig (3),
.BR dellosig (3).


.so man1/alc_bug_report.1

